Cordova প্লাগইন ব্যবস্থাপনা

Cordova প্লাগইন হলো এমন একটি টুল যা আপনার Cordova অ্যাপ্লিকেশনে অতিরিক্ত ফিচার এবং কার্যকারিতা যোগ করতে ব্যবহৃত হয়। এগুলি মোবাইল ডিভাইসের নেটিভ ফিচার (যেমন ক্যামেরা, GPS, মাইক্রোফোন, ফাইল সিস্টেম ইত্যাদি) অ্যাক্সেস করতে সাহায্য করে। Cordova প্লাগইন ব্যবস্থাপনা খুবই গুরুত্বপূর্ণ কারণ এটি আপনার অ্যাপ্লিকেশনকে আরও শক্তিশালী এবং কার্যকরী করে তোলে। এখানে Cordova প্লাগইন ব্যবস্থাপনা নিয়ে বিস্তারিত আলোচনা করা হলো।

১. Cordova প্লাগইন ইনস্টল করা

Cordova প্লাগইন ইনস্টল করা খুব সহজ এবং এটি npm অথবা cordova plugin add কমান্ডের মাধ্যমে করা যেতে পারে।

প্লাগইন ইনস্টল করার সাধারণ কমান্ড:

cordova plugin add <plugin-name>

এখানে <plugin-name> এর জায়গায় আপনি যেই প্লাগইনটি ইনস্টল করতে চান তার নাম দিবেন। যেমন, Camera প্লাগইন ইনস্টল করার জন্য:

cordova plugin add cordova-plugin-camera

আপনি যদি নির্দিষ্ট ভার্সন ইনস্টল করতে চান, তাহলে নিচের মতো কমান্ড ব্যবহার করতে পারেন:

cordova plugin add cordova-plugin-camera@4.0.3

২. প্লাগইন ইনস্টলেশন পরবর্তী কনফিগারেশন

কিছু প্লাগইন ইনস্টল করার পর আপনাকে কনফিগারেশন ফাইল বা অ্যাপের কিছু সেটিংস আপডেট করতে হতে পারে। যেমন, camera প্লাগইন ইনস্টল করার পর যদি আপনি ক্যামেরা ব্যবহারের অনুমতি চান, তবে config.xml ফাইলে কিছু অনুমতি সেট করতে হবে।

উদাহরণস্বরূপ, ক্যামেরা প্লাগইন ব্যবহারের জন্য আপনাকে নিম্নলিখিত অধিকার দিতে হতে পারে:

<platform name="android">
    <permission name="android.permission.CAMERA" />
    <permission name="android.permission.WRITE_EXTERNAL_STORAGE" />
</platform>

৩. ইনস্টল করা প্লাগইন তালিকা দেখা

আপনি যে প্লাগইনগুলো ইনস্টল করেছেন সেগুলির তালিকা দেখতে, নিচের কমান্ড ব্যবহার করতে পারেন:

cordova plugin list

এটি ইনস্টল করা সমস্ত প্লাগইনের তালিকা দেখাবে এবং তাদের ভার্সন তথ্যও দেখাবে।

৪. প্লাগইন আপডেট করা

কিছু সময়ে আপনার ব্যবহার করা প্লাগইনের নতুন সংস্করণ বের হয়, এবং সেগুলোর মধ্যে বাগ ফিক্স, নতুন ফিচার বা পারফরম্যান্স উন্নতি থাকতে পারে। তাই প্লাগইনটি আপডেট করা গুরুত্বপূর্ণ।

নতুন সংস্করণ ইনস্টল করতে নিচের কমান্ড ব্যবহার করুন:

cordova plugin update <plugin-name>

এটি আপনার অ্যাপ্লিকেশনটিতে plugin-name এর সর্বশেষ সংস্করণ ইনস্টল করবে।

৫. প্লাগইন নিষ্ক্রিয়/অপসারণ করা

যদি আপনি কোনও প্লাগইন আর ব্যবহার না করতে চান, তাহলে আপনি এটি নিষ্ক্রিয় বা সরিয়ে ফেলতে পারেন।

প্লাগইন নিষ্ক্রিয় করা:

cordova plugin remove <plugin-name>

অথবা একাধিক প্লাগইন একসাথে সরাতে:

cordova plugin remove cordova-plugin-camera cordova-plugin-geolocation

এই কমান্ডটি আপনার প্রজেক্ট থেকে প্লাগইনগুলি সরিয়ে দেবে।

৬. কাস্টম প্লাগইন তৈরি করা

কখনও কখনও আপনার নিজের কাস্টম প্লাগইন তৈরি করার প্রয়োজন হতে পারে। আপনি যদি কোনও বিশেষ ফিচার বা অ্যাপ্লিকেশনের অংশ তৈরির জন্য প্লাগইন তৈরি করতে চান, তাহলে Cordova প্লাগইন তৈরি করার জন্য আপনি নিচের কমান্ড ব্যবহার করতে পারেন:

cordova plugin create <plugin-name> --plugin-id <plugin-id> --plugin-version <version>

এই কমান্ডটি নতুন একটি প্লাগইন তৈরি করবে, যা আপনার প্রয়োজন অনুযায়ী কাস্টমাইজ করা যাবে।

৭. প্লাগইনগুলির ডকুমেন্টেশন পড়া

প্রতিটি প্লাগইনের নিজস্ব ডকুমেন্টেশন থাকে, যা আপনাকে প্লাগইনটি কীভাবে ব্যবহার করবেন তা জানায়। প্লাগইন ইনস্টল করার পর, সেই প্লাগইনের ডকুমেন্টেশন পড়া গুরুত্বপূর্ণ। আপনি npm অথবা প্লাগইনের গিটহাব পেজে ডকুমেন্টেশন খুঁজে পেতে পারেন।

সারাংশ

Cordova প্লাগইন ব্যবস্থাপনা একটি গুরুত্বপূর্ণ অংশ, কারণ এটি আপনার অ্যাপ্লিকেশনের কার্যকারিতা বৃদ্ধি করে এবং আপনাকে মোবাইল ডিভাইসের নেটিভ ফিচার অ্যাক্সেস করতে দেয়। আপনি npm বা cordova plugin add কমান্ড ব্যবহার করে সহজেই প্লাগইন ইনস্টল করতে পারেন, এবং cordova plugin list দিয়ে ইনস্টল করা প্লাগইনের তালিকা দেখতে পারেন। এছাড়া plugin remove কমান্ড দিয়ে প্লাগইন অপসারণ এবং plugin update কমান্ড দিয়ে প্লাগইন আপডেট করতে পারবেন।

Cordova প্লাগইন হল এমন একটি এক্সটেনশন বা কম্পোনেন্ট যা Cordova অ্যাপ্লিকেশনকে মোবাইল ডিভাইসের নেটিভ ফিচার ও API এর সাথে সংযোগ করতে সাহায্য করে। Cordova অ্যাপ্লিকেশনগুলি মূলত HTML, CSS, এবং JavaScript ব্যবহার করে তৈরি করা হয়, তবে অনেক সময় আপনাকে মোবাইল ডিভাইসের হার্ডওয়্যার বা সিস্টেম ফিচার যেমন ক্যামেরা, GPS, স্টোরেজ, মাইক্রোফোন ইত্যাদি অ্যাক্সেস করতে হয়। এই নেটিভ ফিচারগুলোর সাথে ইন্টিগ্রেশন করার জন্য Cordova প্লাগইন ব্যবহৃত হয়।

Cordova প্লাগইনের ভূমিকা

Cordova প্লাগইন একটি মিডলওয়্যার হিসেবে কাজ করে, যা আপনার JavaScript কোডকে মোবাইল ডিভাইসের নেটিভ ফিচারগুলির সাথে যোগাযোগ করাতে সাহায্য করে। এই প্লাগইনগুলির মাধ্যমে আপনি আপনার Cordova অ্যাপ্লিকেশনকে আরও শক্তিশালী এবং কার্যকরী করতে পারেন।

যেমন:

• GPS সিগন্যাল অ্যাক্সেস করতে,
• ক্যামেরা ব্যবহার করতে,
• ফাইল সিস্টেম অ্যাক্সেস করতে,
• নেটওয়ার্কিং ফিচার যোগ করতে,
• পুশ নোটিফিকেশন পাঠাতে,
• ডিভাইসের সেন্সর ব্যবহার করতে।

Cordova প্লাগইন কিভাবে কাজ করে?

Cordova প্লাগইনগুলো মূলত JavaScript API এবং নেটিভ কোড (Java, Objective-C, Swift) এর একটি মিশ্রণ। যখন আপনি Cordova অ্যাপ্লিকেশন থেকে একটি নেটিভ ফিচার ব্যবহার করতে চান, তখন JavaScript কোডটি প্লাগইনের মাধ্যমে সেই ফিচারের জন্য নেটিভ API কল করতে পারে। প্লাগইনটি ডিভাইসের ফিচারের সাথে যোগাযোগ করার জন্য প্রয়োজনীয় নেটিভ কোড পরিচালনা করে এবং JavaScript থেকে ফলাফল প্রদান করে।

Cordova প্লাগইন এর ব্যবহার

1. ক্যামেরা: ক্যামেরা থেকে ছবি বা ভিডিও নিতে।
   • প্লাগইন: cordova-plugin-camera
2. GPS বা অবস্থান ট্র্যাকিং: ডিভাইসের অবস্থান জানতে।
   • প্লাগইন: cordova-plugin-geolocation
3. ফাইল সিস্টেম: ডিভাইসের ফাইল সিস্টেমে ফাইল পড়া বা লেখা।
   • প্লাগইন: cordova-plugin-file
4. পুশ নোটিফিকেশন: পুশ নোটিফিকেশন পাঠানো।
   • প্লাগইন: phonegap-plugin-push
5. নেটওয়ার্ক সংযোগ: ডিভাইসে ইন্টারনেট কানেকশন স্টেটস চেক করা।
   • প্লাগইন: cordova-plugin-network-information

Cordova প্লাগইন ইন্সটলেশন

Cordova প্লাগইন ইন্সটল করার জন্য সাধারণত cordova plugin add কমান্ড ব্যবহার করা হয়। এখানে একটি উদাহরণ দেওয়া হলো:

উদাহরণ:

ধরা যাক, আপনি ক্যামেরা ফিচার ব্যবহার করতে চান। তখন আপনি নিচের কমান্ডটি ব্যবহার করবেন:

cordova plugin add cordova-plugin-camera

এই কমান্ডটি ক্যামেরা প্লাগইন আপনার প্রোজেক্টে যোগ করবে এবং আপনার অ্যাপ্লিকেশন থেকে ক্যামেরা ফিচার ব্যবহার করার অনুমতি দেবে।

Cordova প্লাগইন ব্যবহারের সুবিধা

1. নেটিভ ফিচার অ্যাক্সেস: Cordova প্লাগইন আপনাকে মোবাইল ডিভাইসের নেটিভ ফিচার ব্যবহার করার সুযোগ দেয়।
2. ক্রস-প্ল্যাটফর্ম সাপোর্ট: একাধিক প্ল্যাটফর্মে (Android, iOS) একই প্লাগইন ব্যবহার করা যায়, তাই কোড পুনঃব্যবহারযোগ্য।
3. সহজ ইনস্টলেশন: প্লাগইন ইনস্টল এবং কনফিগার করা সহজ, এবং অধিকাংশ প্লাগইন npm বা Cordova CLI এর মাধ্যমে ইনস্টল করা যায়।
4. ওপেন সোর্স: অধিকাংশ Cordova প্লাগইন ওপেন সোর্স, তাই আপনি প্রয়োজন অনুযায়ী এটি কাস্টমাইজ করতে পারেন।

Cordova প্লাগইন ব্যবহারের সীমাবদ্ধতা

1. প্লাগইনের সীমাবদ্ধতা: কিছু প্লাগইন শুধু কিছু প্ল্যাটফর্মে কাজ করতে পারে এবং আপনার কাঙ্খিত ফিচারটি না পেতে পারেন।
2. নেটিভ কোডের প্রয়োজন: কিছু প্লাগইন ব্যবহারের জন্য নেটিভ কোড বা প্ল্যাটফর্মের জন্য অতিরিক্ত কনফিগারেশন প্রয়োজন হতে পারে।
3. অ্যাপ সাইজ বৃদ্ধি: কিছু প্লাগইন অ্যাপ্লিকেশনের সাইজ বৃদ্ধি করতে পারে, কারণ তারা নেটিভ কোড অন্তর্ভুক্ত করে।

সারাংশ

Cordova প্লাগইন হল এক্সটেনশন বা কম্পোনেন্ট যা আপনার Cordova অ্যাপ্লিকেশনকে মোবাইল ডিভাইসের নেটিভ ফিচারগুলির সাথে সংযোগ করতে সাহায্য করে। এটি HTML, CSS, এবং JavaScript দিয়ে তৈরি অ্যাপ্লিকেশনে নেটিভ ফিচারের ব্যবহার সহজ করে দেয় এবং আপনার অ্যাপ্লিকেশনকে আরও কার্যকরী ও শক্তিশালী করে তোলে।

Cordova প্লাগইন হল এমন একটি কাস্টম কোড যা আপনাকে মোবাইল ডিভাইসের নেটিভ ফিচারগুলি যেমন ক্যামেরা, GPS, স্টোরেজ ইত্যাদি ব্যবহার করতে সাহায্য করে। Cordova প্লাগইন আপনাকে HTML, CSS, এবং JavaScript ব্যবহার করে মোবাইল অ্যাপ্লিকেশনের জন্য নেটিভ ফিচার এক্সেস করতে দেয়।

প্লাগইন ইনস্টলেশন প্রক্রিয়া

১. Cordova প্রকল্প তৈরি করা (যদি না থাকে)

প্রথমে, একটি Cordova প্রকল্প তৈরি করুন:

cordova create myApp
cd myApp

২. আপনার প্রয়োজনীয় প্ল্যাটফর্ম যোগ করুন

Cordova অ্যাপ্লিকেশনটি যেসব প্ল্যাটফর্মে চলবে, সেই প্ল্যাটফর্মগুলিকে প্রকল্পে যোগ করতে হবে। উদাহরণস্বরূপ, Android এবং iOS প্ল্যাটফর্ম যোগ করতে:

cordova platform add android
cordova platform add ios

৩. প্লাগইন ইনস্টল করা

Cordova প্লাগইন ইনস্টল করার জন্য cordova plugin add কমান্ড ব্যবহার করা হয়। উদাহরণস্বরূপ, Camera প্লাগইন ইনস্টল করতে:

cordova plugin add cordova-plugin-camera

কিছু প্লাগইন প্যাকেজ ম্যানেজারের মাধ্যমে ইনস্টল করা যায়, যেমন:

cordova plugin add https://github.com/apache/cordova-plugin-camera

এটি আপনার প্রকল্পে প্লাগইন যুক্ত করবে এবং আপনার অ্যাপ্লিকেশনটি সেই প্লাগইন ব্যবহার করতে সক্ষম হবে।

৪. প্লাগইন ব্যবহার করা

প্লাগইন ইনস্টল হওয়ার পর, আপনি JavaScript ব্যবহার করে তার ফিচারগুলিকে অ্যাক্সেস করতে পারবেন। উদাহরণস্বরূপ, ক্যামেরা প্লাগইন ব্যবহার করে একটি ছবি তোলার জন্য কোড:

navigator.camera.getPicture(onSuccess, onFail, {
    quality: 50,
    destinationType: Camera.DestinationType.DATA_URL
});

function onSuccess(imageData) {
    var image = document.getElementById('myImage');
    image.src = "data:image/jpeg;base64," + imageData;
}

function onFail(message) {
    alert('Failed because: ' + message);
}

গ্লোবাল প্লাগইন ইনস্টলেশন

যদি আপনি একটি প্লাগইন গ্লোবালি ইনস্টল করতে চান, তাহলে -g অপশন ব্যবহার করতে পারেন:

cordova plugin add <plugin-name> --save

প্লাগইন ইনস্টলেশনের পরে কাজ শুরু করা

1. কনফিগারেশন সেট করা:
   কিছু প্লাগইন ইনস্টল করার পর, আপনি আপনার config.xml ফাইলে কিছু কনফিগারেশন সেট করতে হতে পারে।

2. কমান্ড লাইন দিয়ে অ্যাপ রান করা:
   আপনি আপনার অ্যাপটি টেস্ট করতে চান, তাহলে নিচের কমান্ডটি ব্যবহার করতে পারেন:

   cordova run android
   cordova run ios

ইনস্টল করা প্লাগইন তালিকা দেখুন

যে প্লাগইনগুলো আপনি আপনার Cordova প্রকল্পে ইনস্টল করেছেন, তা দেখতে:

cordova plugin list

প্লাগইন আনইনস্টল করা

যদি আপনি কোনো প্লাগইন আনইনস্টল করতে চান, তাহলে নিচের কমান্ডটি ব্যবহার করতে পারেন:

cordova plugin remove <plugin-name>

সারাংশ

• Cordova প্লাগইন ইন্সটল করতে cordova plugin add ব্যবহার করা হয়।
• বিভিন্ন ধরনের প্লাগইন ব্যবহার করা যায় যেমন ক্যামেরা, জিপিএস, স্টোরেজ ইত্যাদি।
• প্লাগইন ইনস্টলেশনের পর আপনি JavaScript থেকে সেই ফিচার ব্যবহার করতে পারবেন।
• Cordova প্লাগইনগুলো গ্লোবালি অথবা লোকালি ইনস্টল করা যায়, এবং আপনি প্রয়োজনে প্লাগইন আনইনস্টলও করতে পারবেন।

এভাবে Cordova প্লাগইন ব্যবহার করে মোবাইল অ্যাপ্লিকেশনকে আরও ফিচারসমৃদ্ধ এবং কার্যকরী করা সম্ভব।

Apache Cordova বিভিন্ন প্লাগইন সমর্থন করে যা আপনাকে মোবাইল ডিভাইসের নেটিভ ফিচার যেমন ক্যামেরা, জিপিএস, এবং ফাইল সিস্টেম ব্যবহার করতে সহায়ক। এই প্লাগইনগুলো আপনাকে মোবাইল অ্যাপ্লিকেশনগুলিতে ডিভাইসের হার্ডওয়্যার ফিচার অ্যাক্সেস করতে সহায়ক। নিচে এই প্লাগইনগুলো ব্যবহার করার জন্য একটি গাইড দেওয়া হলো:

১. Camera প্লাগইন

Camera প্লাগইন ব্যবহার করে আপনি মোবাইল ডিভাইসের ক্যামেরা অ্যাক্সেস করতে পারেন, যাতে ব্যবহারকারীরা ছবি তুলতে বা ক্যামেরা ব্যবহার করতে পারেন।

Camera প্লাগইন ইনস্টল করা

1. Camera প্লাগইন যোগ করা:

   প্রথমে, Cordova Camera প্লাগইন ইনস্টল করতে নিচের কমান্ড ব্যবহার করুন:

   cordova plugin add cordova-plugin-camera

2. Camera ব্যবহার করা:

   এবার JavaScript কোডে ক্যামেরা ব্যবহার করতে পারেন। একটি উদাহরণ:

   navigator.camera.getPicture(onSuccess, onFail, {
       quality: 50,
       destinationType: Camera.DestinationType.FILE_URI
   });
   
   function onSuccess(imageURI) {
       var image = document.getElementById('myImage');
       image.src = imageURI;
   }
   
   function onFail(message) {
       alert('Failed because: ' + message);
   }

   এখানে getPicture() ফাংশনটি ক্যামেরা থেকে ছবি তুলে নির্দিষ্ট onSuccess ফাংশনে পাঠাবে।

২. Geolocation প্লাগইন

Geolocation প্লাগইন ব্যবহার করে আপনি ডিভাইসের লোকেশন (GPS) অ্যাক্সেস করতে পারেন, যা ব্যবহারকারীর বর্তমান অবস্থান জানাতে ব্যবহৃত হয়।

Geolocation প্লাগইন ইনস্টল করা

1. Geolocation প্লাগইন যোগ করা:

   Cordova Geolocation প্লাগইন যোগ করতে নিচের কমান্ডটি ব্যবহার করুন:

   cordova plugin add cordova-plugin-geolocation

2. Geolocation ব্যবহার করা:

   JavaScript কোডে Geolocation ব্যবহার করার একটি উদাহরণ:

   navigator.geolocation.getCurrentPosition(onSuccess, onError);
   
   function onSuccess(position) {
       var latitude = position.coords.latitude;
       var longitude = position.coords.longitude;
       alert("Latitude: " + latitude + ", Longitude: " + longitude);
   }
   
   function onError(error) {
       alert("Error occurred. Error code: " + error.code);
   }

   এই কোডটি ব্যবহারকারীর বর্তমান অবস্থান (latitude ও longitude) সংগ্রহ করবে এবং onSuccess ফাংশনে পাঠাবে।

৩. File System প্লাগইন

File System প্লাগইন ব্যবহার করে আপনি মোবাইল ডিভাইসে ফাইল তৈরি, পড়া, লেখার এবং মুছে ফেলার কাজ করতে পারেন। এই প্লাগইনটি মূলত ফাইল সিস্টেমের সঙ্গে যোগাযোগ করতে ব্যবহৃত হয়।

File System প্লাগইন ইনস্টল করা

1. File System প্লাগইন যোগ করা:

   Cordova File প্লাগইন ইনস্টল করতে নিচের কমান্ড ব্যবহার করুন:

   cordova plugin add cordova-plugin-file

2. File System ব্যবহার করা:

   ফাইল তৈরি ও পড়ার জন্য একটি উদাহরণ:

   window.resolveLocalFileSystemURL(cordova.file.dataDirectory, function(directoryEntry) {
       directoryEntry.getFile("example.txt", { create: true, exclusive: false }, function(fileEntry) {
           writeFile(fileEntry);
       });
   });
   
   function writeFile(fileEntry) {
       fileEntry.createWriter(function(fileWriter) {
           var blob = new Blob(['Hello Cordova!'], { type: 'text/plain' });
           fileWriter.write(blob);
       });
   }

   এই কোডটি example.txt নামের একটি ফাইল তৈরি করবে এবং তাতে "Hello Cordova!" লেখা লিখবে।

প্লাগইন ব্যবহার করার সারাংশ

• Camera: এটি মোবাইল ডিভাইসের ক্যামেরা ব্যবহার করতে সহায়ক। আপনি ছবি তুলতে পারবেন বা ভিডিও ক্যাপচার করতে পারবেন।
• Geolocation: এটি ডিভাইসের জিপিএস ডেটা অ্যাক্সেস করতে সাহায্য করে, যার মাধ্যমে ব্যবহারকারীর বর্তমান অবস্থান জানা যায়।
• File System: এটি মোবাইল ডিভাইসের ফাইল সিস্টেমের মাধ্যমে ফাইল তৈরি, পড়া এবং লেখার কাজ করতে সহায়ক।

এই তিনটি প্লাগইন Cordova অ্যাপ্লিকেশনকে আরও শক্তিশালী এবং কার্যকরী করে তোলে, যেখানে ডিভাইসের ক্যামেরা, জিপিএস এবং ফাইল সিস্টেম ব্যবহার করা সম্ভব।

Cordova প্ল্যাটফর্মে কাস্টম প্লাগইন তৈরি করা এবং ব্যবহার করা একটি সাধারণ প্রক্রিয়া। যখন আপনি এমন কিছু ফিচার চান যা Cordova এর ডিফল্ট প্লাগইন সমর্থন করে না, তখন আপনি একটি কাস্টম প্লাগইন তৈরি করতে পারেন। এই প্লাগইনটি আপনার প্রয়োজন অনুযায়ী নেটিভ কোড (Java/Kotlin/Swift/Objective-C) ব্যবহার করে কাজ করতে পারে এবং তারপর জাভাস্ক্রিপ্টের মাধ্যমে এটি অ্যাক্সেস করা যায়।

১. Custom প্লাগইন তৈরি করার প্রক্রিয়া

ধাপ ১: নতুন প্লাগইন তৈরি করা

Cordova CLI ব্যবহার করে নতুন প্লাগইন তৈরি করতে নিম্নলিখিত কমান্ড ব্যবহার করুন:

cordova plugin create myPlugin org.example.myPlugin MyPlugin

এটি একটি নতুন প্লাগইন ফোল্ডার তৈরি করবে যেখানে আপনার প্লাগইন সম্পর্কিত সব ফাইল থাকবে।

ধাপ ২: প্লাগইন কোড লেখা

আপনার প্লাগইনটি Java (Android এর জন্য) বা Swift/Objective-C (iOS এর জন্য) এ নেটিভ কোড লিখবে। উদাহরণস্বরূপ, যদি আপনার প্লাগইনটি ডিভাইসের ব্যাটারি স্তর দেখতে চায়, তাহলে Android এবং iOS এর জন্য আলাদা কোড থাকবে।

Android প্ল্যাটফর্মে (Java):

package org.example.myPlugin;

import org.apache.cordova.CallbackContext;
import org.apache.cordova.CordovaPlugin;
import org.apache.cordova.PluginResult;
import android.content.Context;
import android.os.BatteryManager;

public class MyPlugin extends CordovaPlugin {
    @Override
    public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {
        if (action.equals("getBatteryLevel")) {
            Context context = cordova.getActivity().getApplicationContext();
            BatteryManager batteryManager = (BatteryManager) context.getSystemService(Context.BATTERY_SERVICE);
            int level = batteryManager.getIntProperty(BatteryManager.BATTERY_PROPERTY_CAPACITY);
            callbackContext.success(level + "%");
            return true;
        }
        return false;
    }
}

iOS প্ল্যাটফর্মে (Swift):

import Cordova

@objc(MyPlugin) class MyPlugin : CDVPlugin {
    @objc func getBatteryLevel(_ command: CDVInvokedUrlCommand) {
        let level = UIDevice.current.batteryLevel * 100
        let pluginResult = CDVPluginResult(status: CDVCommandStatus_OK, messageAs: "\(Int(level))%")
        self.commandDelegate.send(pluginResult, callbackId: command.callbackId)
    }
}

ধাপ ৩: প্লাগইন তথ্য যোগ করা

প্লাগইনের plugin.xml ফাইলে প্লাগইনের বিবরণ এবং ব্যবহারযোগ্য কমান্ড যুক্ত করুন:

<plugin id="org.example.myPlugin" version="1.0.0">
    <name>MyPlugin</name>
    <description>Custom plugin to get battery level</description>
    <platform name="android">
        <source-file src="src/android/MyPlugin.java" target-dir="src/org/example/myPlugin"/>
    </platform>
    <platform name="ios">
        <source-file src="src/ios/MyPlugin.swift" target-dir="src/org/example/myPlugin"/>
    </platform>
    <js-module src="www/myPlugin.js">
        <clobbers target="cordova.plugins.MyPlugin"/>
    </js-module>
</plugin>

ধাপ ৪: প্লাগইন JS ফাইল তৈরি

এখন, আপনার প্লাগইনটি JavaScript মাধ্যমে অ্যাক্সেস করতে হবে। www/myPlugin.js ফাইলে নিম্নলিখিত কোড যোগ করুন:

var exec = require('cordova/exec');

var myPlugin = {
    getBatteryLevel: function(success, error) {
        exec(success, error, "MyPlugin", "getBatteryLevel", []);
    }
};

module.exports = myPlugin;

ধাপ ৫: প্লাগইন ইনস্টল এবং ব্যবহার

প্লাগইনটি ইনস্টল করার জন্য, আপনার Cordova প্রজেক্টে নিম্নলিখিত কমান্ড চালান:

cordova plugin add /path/to/your/plugin

এখন, আপনার অ্যাপ্লিকেশনে এই প্লাগইনটি ব্যবহার করতে পারেন:

cordova.plugins.MyPlugin.getBatteryLevel(function(batteryLevel) {
    console.log("Battery Level: " + batteryLevel);
}, function(error) {
    console.error("Error: " + error);
});

২. Custom প্লাগইন ব্যবহারের উদাহরণ

ধরা যাক, আপনি একটি প্লাগইন তৈরি করেছেন যা ডিভাইসের ব্যাটারি স্তর রিটার্ন করে। নিচে একটি উদাহরণ দেওয়া হলো, যেখানে আমরা এই প্লাগইনটি ব্যবহার করে ব্যাটারি স্তর প্রদর্শন করব।

এপ্লিকেশন কোড:

document.addEventListener("deviceready", function() {
    cordova.plugins.MyPlugin.getBatteryLevel(function(batteryLevel) {
        alert("Battery Level: " + batteryLevel);
    }, function(error) {
        alert("Error: " + error);
    });
});

এই কোডে, deviceready ইভেন্টটি নিশ্চিত করে যে আপনার অ্যাপ্লিকেশনটি ডিভাইসের সাথে প্রস্তুত এবং কাস্টম প্লাগইনটি কাজ করতে পারে।

সারাংশ

1. Custom প্লাগইন তৈরি: Cordova প্লাগইন তৈরি করতে, আপনি Java বা Swift/Objective-C এ কোড লিখবেন যা নির্দিষ্ট নেটিভ কার্যক্ষমতা প্রদান করবে এবং JavaScript এর মাধ্যমে অ্যাক্সেসযোগ্য হবে।
2. প্লাগইন ইনস্টল করা: প্লাগইন তৈরি করার পর, এটি আপনার Cordova প্রজেক্টে ইনস্টল করতে হবে এবং তারপর এটি ব্যবহার করতে হবে।
3. JS ফাইল তৈরি: প্লাগইনকে JavaScript এর মাধ্যমে অ্যাক্সেসযোগ্য করতে www/myPlugin.js ফাইল তৈরি করতে হবে।

এভাবে আপনি Cordova এ কাস্টম প্লাগইন তৈরি এবং ব্যবহার করতে পারবেন।